---
title: "submit button · RUAL Documentation"
description: "A submit button to handle your form using a POST or PUT API. An error will be shown if the API responds with a non-200 status code and an error message.…"
canonical: https://docs.rual.nl/block-types/state elements/state_submit_button
language: en
---

# submit button

This block is part of the [`state elements`](https://docs.rual.nl/block-types/state%20elements) group and was last modified in core [`v13.0.6`](https://docs.rual.nl/core-versions/130006).

A submit button to handle your form using a POST or PUT API. An error will be shown if the API responds with a non-200 status code and an error message. For this to work a form element needs to be used.

- form id `form_id` required `value`

- text `value` required `value`

- parameters required `object`

- query required `object`

- state key `state` required `value`

- icon `value`

- icon: style `iconstyle` `uistyle`

- icon: class `iconclass` `uiclass`

- class `uiclass` `uiclass`

- style `uistyle` `uistyle`

- attributes `uiattributes` `uiattributes`

- on success `inpinsuccessfunction` `inpinfunction`

- state `state`

### Core Releases